home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / p / portfoli / dfue / pfboot / xterm1.doc < prev    next >
Encoding:
Text File  |  1996-10-30  |  4.1 KB  |  100 lines
  1. XTERM1.COM - The second generation Terminal with XModem and
  2. Text File Transfer for the Atari/DIP Portfolio.
  3.  
  4. by Jim Straus                        November 24, 1989
  5. Copyright 1989 by Jim Straus                All rights reserved
  6. Certain portions of the code are (c) 1989 by Atari and DIP.
  7.  
  8. This program is placed in the public domain by Atari Corporation
  9. and is not for sale.
  10.  
  11. No warranty is given or implied for this programming system.
  12. In no event shall Atari be held liable for any damages incurred 
  13. from misuse of this program.  The user assumes all risk and
  14. responsibility.
  15.  
  16. This program will only work on the Atari Portfolio
  17. computer.  It is a simple terminal program for the
  18. Serial Interface.  It  allows files to be sent or received
  19. using the XModem protocol.  It also allows files to be sent
  20. with no translation and files to be captured.
  21.  
  22. To use the program, select serial port parameters from the
  23. built-in Setup program.  The Initialize! command does not
  24. need to be given as the program will attempt to initialize
  25. the serial port itself.  You may also want to set the External
  26. Display to Tracked (80x25).  Then start the program by typing
  27. XTERM1
  28.  
  29. at the DIP-DOS prompt.  You will see a greeting, and
  30. anything you type is sent out the serial port.  F1 may be used
  31. to exit the program (Note that the Atari key also generates an
  32. F1 key code).
  33.  
  34. During the session, F2 may be used to start receiving a file
  35. using the XModem protocol.  You will be prompted for a file
  36. name, and then the program will wait for the file to be
  37. transferred.  Each block successfully received will cause a
  38. period to be displayed.  When the file is done, "Done" will
  39. be displayed and you will be back in the terminal portion.
  40. While the program is transferring, the F1 key may be used to
  41. abort the transfer.
  42.  
  43. Sending a file is started with the F3 key and proceeds in a
  44. similar fashion.  If the file was not found, you will just see
  45. "Done" displayed.
  46.  
  47. Note that XModem always transfers files in 128 byte blocks,
  48. so files will tend to be rounded up to the nearest 128 byte
  49. length.  When receiving text files, you may also see extra
  50. space on the end, depending on whether or not the sending end
  51. put in a Control-Z terminating character.  XTERM1 does not put
  52. in such characters and just pads with zeros.
  53.  
  54. The XModem time out values in this program have not been
  55. tested with a packet network (such as that used by Compuserve),
  56. but have been adjusted to Compuserve's suggested values.
  57.  
  58. SHIFT-F1 displays the commands available to you.
  59.  
  60. Capturing text is controlled with the SHIFT-F2 key.  The first
  61. time it is pressed, you will be prompted for a file name.  From
  62. then on anything received is also saved in the file.  To stop
  63. capturing, use the SHIFT-F2 key again.  It will tell you it is
  64. "Done".  Text may be captured through XModem transfers and text
  65. sending, but only received text that is displayed will be saved
  66. in the capture file.
  67.  
  68. SHIFT-F3 is used to send a text file.  It prompts for a file
  69. name and the file is sent.  When the file is done, you will
  70. again see "Done".
  71.  
  72. XTERM1 will also take command line options.  The three forms are:
  73.     XTERM1 -r filename
  74.     XTERM1 -s filename
  75.     XTERM1 -h
  76.  
  77. The -r option will enter the XModem receive state, and when it
  78. is done receiving the file, the program will exit.  The -s
  79. option enters the XModem send state.  The -h option displays a
  80. help message of various options.
  81.  
  82. In the case of a Macintosh running the Red
  83. Ryder (tm of FreeSoft Inc.) terminal program, the Portfolio
  84. should have a BACKUP.BAT file that looks like:
  85.     echo RECX filename.txt>aux
  86.     XTERM1 -s filename.txt
  87. with the above lines repeated for each file to be backed up.
  88. Red Ryder is left in HOST mode, so the above sequence should
  89. automatically send FILENAME.TXT to the Macintosh.  A similar
  90. process is used to restore the files:
  91.     echo SENDX filename.txt>aux
  92.     XTERM1 -r filename.txt
  93.  
  94. Occasional hangs can be alleviated by stopping the transfer on
  95. the Macintosh and sending two Control-Xs to cancel that file.
  96. Try to build scripts to drive other host machine terminal programs 
  97. too and post them here as well.
  98.  
  99.  
  100.